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Enterprise Cluster Master 
Toolkit Version B.01.03 Release 
Notes for HP-UX lli 


Announcements 

The Enterprise Cluster Master Toolkit is a set of templates and scripts 
that allow you to configure ServiceGuard packages for the H P Domain 
I nternet servers as well as for several third-party database management 
systems. This unified set of high availability tools is being released 
together with theHP-UX Mission Critical Operating Environment, 
HP-UX lli B.11.11. 

The master toolkit is a collection of specific product toolkits, which 
i ncl ude the fol lowi ng: 

• HA Foundation Monitor toolkit, designed to monitor the status of an 
entire mission critical environment. 

• H A i nternet tool kits for use with HP Domai n server products. 

• Databasetoolkitsfor Oracle, Informix, Sybase, and Progress database 
management systems. 
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What's in this Version 

Version B.01.03 contains a new toolkit for the use of Oracle Standby 
Database as a logical data replication method in a continental cluster. 
This toolkit, which is installed into /opt/cmciuster/tooikit/SGOSB, 
allows you to replicate data between the primary cluster and the 
recovery cl uster. Refer to the readme-cc fi le i n the sgosb di rectory for 
complete instructions on using the files that are provided in the toolkit. 

Effective with this release, the following product toolkits are available: 

• HA Foundation Monitor Toolkit. This toolkit is designed to monitor 
the status of the mission critical environment. It assists the H P 
support engineer with tracking cluster availability in the areas of 
cluster nodes, network components, and packages. A cluster 
availability report will be generated nightly if an event occurs in any 
of these areas. 

A white paper describing this toolkit, "I nstalling and Configuring the 
Foundation Monitor Toolkit," is available on the documentation web 
site: 

http://docs.hp.com/hpux/ha 

• HA I nternet Toolkits. These tool kits enable you to run all your 
Domain server software as ServiceGuard packages. Each toolkit 
contains example scripts and package configuration files, together 
with a RE ADM E file that explains how to customize the package for 
your needs. Toolkits are provided for the following Domain 
components: 

— FastTrack Server 

— Enterprise Server 

— Enterprise Server Pro 

— Proxy Server 

— Directory Server 

— Messaging Server 

— Col I abra Server 

— Calendar Server 
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Refer tothe H P Domain ReleaseNotes on H P-UX 10.20 (J 1582-90112) 
or the HP Domain ReleaseNotes on HP-UX 11.0 (J 1582-90128) for a 
discussion of recent changes to these products, as well as a 
description of problems and workarounds. 

• DatabaseToolkits. These are provided to simplify the setup of 
ServiceGuard packages for your database software. Each toolkit 
contains example scripts and package configuration files, together 
with a RE ADM E file that explains how to customize the package for 
your needs. Toolkits are included for the following database products: 

— Informix 

— Oracle 

— Oracle 8i’s Oracle Standby Database 

— Progress 

— Sybase. 

Minor corrections and enhancements are included with this release. 
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Compatibility Information and Installation 
Requirements 

Compati bility 

The EnterpriseCluster Master Toolkit requires the installation of the 
HP-UX operating system together with either MC/ServiceGuard 
(B3935CA or B3935DA) or ServiceGuard OPS Edition (B5161DA or 
B5161EA), formerly known as MC/LockManager. 

Compatible versions of ServiceGuard and ServiceGuard OPS Edition are 
shown in the following tablefor the Foundation Monitor: 

Foundation Monitor Compatibility with ServiceGuard and 
HP-UX 


Foundation 

Monitor 

Toolkit Version 

HP-UX Version 

ServiceGuard 

Version 

ServiceGuard 

OPS Edition 
Version 

B.01.47 

HP-UX 10.20 

A. 10.10 or 
greater 

A.10.07.01 or 
greater 

B.01.47 

HP-UX 11.0 

A. 11.01 or 
greater 

A. 11.01 or greater 

B.01.47 

HP-UX lli 

B. 11.11 

A. 11.09 or 
greater 

A. 11.09 or greater 


Compatible versions of MC/ServiceGuard and ServiceGuard OPS Edition 
are shown in the foil owing tablefor the database and internet toolkits: 

Database and I nternet Toolkit Compatibility with 
MC/ServiceGuard and ServiceGuard OPS Edition 


Master Toolkit 

Version 

HP-UX Version 

ServiceGuard 

Version 

ServiceGuard 

OPS Edition 
Version 

B.01.03 

HP-UX 10.20 

A.10.10 or 
greater 

A.10.07.01 or 
greater 
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Database and Internet Toolkit Compatibility with 
MC/ServiceGuard and ServiceGuard OPS Edition 


Master Toolkit 
Version 

HP-UX Version 

ServiceGuard 

Version 

ServiceGuard 

OPS Edition 
Version 

B.01.03 

HP-UX 11.0 

A.11.01 or 
greater 

A. 11.01 or greater 

B.01.03 

HP-UX 1 li 

B.ll.ll 

A. 11.09 or 
greater 

A. 11.09 or greater 


Compatible versions of specific database and I nternet server software 
products are shown in the foil owing table: 

Script Compatibility with Internet Servers and Databases 


Internet Server or 
Database Name 

Internet Server or 

Database Version (as 
shown in swlist output) 

Toolkit Version 
(“what” string) 

FastTrack Server 

B.03.01.05 

B.01.02 

Enterprise Server 

B.03.06.00 

B.01.02 

Enterprise Server Pro 

B.03.05.04 

B.01.02 

Proxy Server 

B.03.05.04 

B.01.02 

Directory Server 

B.03.01.03 

B.01.02 

Messaging Server 

B.03.05.04 

B.01.02 

Collabra Server 

B.03.05.01 

B.01.02 

Calendar Server 

B.03.05.02 

B.01.02 

Informix 

All 

A.10.11 

Oracle 

7.3.x, 8.0.x, 8.1.x 

B.01.02 

Oracle Standby Database 

B.01.03 

B.01.03 

Sybase 

10.0.2 

B.01.02 

Progress 

7.3.A 

A.10.11 
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Installation 

The Enterprise Cluster Master Tool kit is installed on your systems when 
you install the Mission Critical Operating Environment. The locations of 
the specific toolkits are given in the next sections. 

Location of Foundation Monitor Toolkit 

The foundation monitor toolkit is found in the following directory: 

Directory Pathnames of Toolkits 


Toolkit 

Directory Pathname 

HA Foundation Monitor 

/opt/cmcluster/toolkit/foundation 


Follow the instructions in the readme.pdf file that accompanies the 
toolkit. 

Locations of Internet Toolkits 

The I nternet toolkits are found in the following directories: 

Directory Pathnames of I nternet Toolkits 


Internet Toolkit 

Directory Pathname 

FastTrack Server 

/opt/cmcluster/toolkit/fasttrack 

Enterprise Server 

/opt/cmcluster/toolkit/domain 

Enterprise Server Pro 

/opt/cmcluster/toolkit/domain 

Proxy Server 

/opt/cmcluster/toolkit/domain 

Directory Server 

/opt/cmcluster/toolkit/domain 

Messaging Server 

/opt/cmcluster/toolkit/domain 

Collabra Server 

/opt/cmcluster/toolkit/domain 

Calendar Server 

/opt/cmcluster/toolkit/domain 


Follow the instructions in the READM E filethat accompanies thetoolkit 
you wish to configure as a package. 
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Locations of Database Tool kits 

The database tool kits are found in the following directories: 


Directory Pathnames of Database Toolkits 


Database Toolkit 

Directory Pathname 

Informix 

/opt/cmcluster/toolkit/informix 

Oracle 

/opt/cmcluster/toolkit/oracle 

Oracle Standby 

/opt/cmcluster/toolkit/SGOSB 

Sybase 

/opt/cmcluster/toolkit/Sybase 

Progress 

/opt/cmcluster/toolkit/progress 


Follow the instructions in the READM E filethat accompanies thetoolkit 
you wish to configure as a package. 


What Manuals are Available for this Version 

For information about configuring packages using the tool kits, refer to 
the foil owing manuals. I n addition, be sure to review the README file 
that accompanies thetoolkit you are using. 

• Managing MC/ ServiceGuard (B3936-90026) 

• Configuring OPS Clusters with ServiceGuard OPS Edition 
(B 5158-90026) 

I f you are a Domai n user, you should refer to the H P Domai n Release 
Notes on HP-UX 10.20 (J 1582-90112) or the H P Domain Release Notes on 
HP-UX 11.0 (J 1582-90128) for a discussion of recent changes tothese 
products as well as a discussion of problems and workarounds. 

For the Foundation Monitor toolkit, a white paper entitled "I nstalling 
and Configuring the Foundation Monitor Toolkit" now appears on the H P 
documentation web page: 

http://docs.hp.com/hpux/ha 
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Patches and Fixes in this Version 

There are no patches or fixes for this version. 
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Known Problems and Workarounds 

The following describes known problems with the Enterprise Cluster 
Master Toolkit and workarounds for them. 

I f you are a Domai n user, you should refer to the H P Domai n Release 
Notes on HP-UX 10.20 (J 1582-90112) or the H P Domain Release Notes on 
HP-UX 11.0 (J 1582-90128) for a discussion of additional problems and 
workarounds. 

Naming of Netscape Server Instances 

• What is the problem? If you configure multiple instances of the same 
Netscape server type, and the Serverl D of one server is a substring of 
the Serverl D of another server, ServiceGuard may fail the wrong 
package unexpectedly. 

• What is the workaround? Choose distinct, non-overlapping instance 
names as in the foil owing example: 

ServerlDl: httpd-defaultl 

ServerID2: httpd-default2 


Do not use httpd-default for ServerlDl and httpd-def aultl for 
ServerID2. 


Changed Directory Location and Port Setting for 
Enterprise Server (Version 3.6) 

• What is the problem? I n Netscape Enterprise Server (version 3.6), the 
installation directory and port setting have been modified. 

• What is the workaround? I n the runhalt script enterprisesh (version 
B.01.02) Iine51, modify the environment variable SE RVER as 
follows, to reflect the new installation directory: 

SERVER=/opt/ns-enterprise3 6/https-${SERVER_ID} 


When accessing the administration server for Enterprise Server 
version 3.6, use port 17493. For example in your browser, use the 
following URL: 


Chapter 1 


11 




Enterprise Cluster Master Toolkit Version B.01.03 Release Notes for HP-UX 
11 i 

Known Problems and Workarounds 

http://192.1.1.3:17493 

where 192.1.1.3 is the IP address of the system on which you are 
running the administration server. 

Failure of the uxwdog Monitoring Process 

• What is the problem? In Enterprise Server version 3.6, a Unix 
daemon, uxwdog, now monitors the health of the web server daemon, 
known as https-< InstanceName>, where InstanceName is the name 
you give to a specific server instance. (The default daemon name is 

https-default.) 

I f the web server process termi nates, the uxwdog daemon wi 11 
automatically restart the web server daemon. The problem is that 
when the uxwdog daemon terminates with the web server still 
running, the administration server cannot be used tostop or start the 
Webserver. (This problem can be caused by using the command kill -9 
<PI D>, where <PI D> is the process id of the uxwdog daemon.) 

F urthermore, the tool kit that is monitoring the uxwdog daemon will 
cause the package to fail over to the adoptive node, and it will fail to 
run on the adoptive node. 

• What is the workaround? If the uxwdog daemon fails, the web server 
process should be manually killed as in the following: 

kill -9 <PID> 

where <pid> is the process id of the web server process. This will 
allow the web server to be started through the control of the 
administration server. 
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Software Availability in Native Languages 

The Enterprise Cluster Master Toolkit is not available in native 
language versions. 
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